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In column 15, line 30, below "</html> ! 
insert 



APPENDIX D 

A portion of an embodiment of the device tester 304 

^include <windows.h> 
#include <tcharh> 
#inc!ude<stdlib.h> 
^include <stdio.h> 
^include <setupapi.h> 
^include <cfgmgr32.h> 
^include <string.h> 
#include <maJlocb> 
Wnclude <newdev.h> 

#define ARRAYSIZE(x) (sizeof(xYsi2eof(x[0])) 

define INSTANCEID_PREFDC_CHAR TEXTC@ f ) // character used to prefix instance ID'S 

fldefme CLASS J>REFEK_CHAR TEXT( 1==r ) // character used to prefix class 

name 

^define WILD_CHAR TEXTf* 1 ) // wild character 

fldefine QUOTE_PREFIX_CHAR TEXT(V) // prefix character to ignore wild 

characters 
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int EnumeratcDeviceO; 

im removeDevice(char *devID); 

LPTSTR GetDeviceD<scription(HDEVTNFO DevsJ»SP_DEVlNFO_DATA Dcvlnfo); 

BOOL DumpDeviceDescrfHDEVINFO Devs,PSP_DEVINFO_DATA Devlnfo); BOOL 
DumpDevtceStatus(KDEVINFO Dcv$,PSP DEVINFO_DATA Devlnfo); BOOL 
DumpDcviccWithInfo(HDEVINFO Devs.PSP_DEVINFO.DATA Devtofo.LPCTSTR Info); 

#ifdef_UNlCODE 

^define UPDATEDRTVERFORPLUOANDPLAYDEVICES 

"UpdateDriverForPlugAndPlayDevicesW'' 

#clsc 

fWefine UPDATEDRIVERFORPLUOANDPLAYDEV1CES 

"UpdatcDriverForPlugAndPlayDevicesA" 

ftendif 

// 

//exit codes 

// 

#define EXIT OK. (0) 
#define EXITREBOOT (1) 
Mefrne EXIT_FAIL (2) 
Sdcfme EXIT_USAGE (3) 
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typed ef struct { 
DWORD count; 
DWORD control; 
BOOL reboot; 
LPCTSTR strSuccess; 
LPCTSTR strRebooi; 
LPCTSTR strFail; 

J 

GcncricContext; 

^define FtND^DEVICE 0x00000001 // display device 
^define FINDJ5TATUS 0x00000002 // display status of device 
tfdefine FfND_RESOURCES 0x00000004 // display resources of device 
#defme FIND DRIVERS 0x00000008 // display drivers used by device 
#defme FrND~HWIDS 0x00000010 // display hw/compat id's used by 
device 

^define FIND DRJVERNODES 0x00000020 // display dri vcr nodes for a device. 
Devcon.cpp 



^include "devcon.h 11 
^include <string.h> 

FILE 'stream; 
char *outfile; 
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TCHAR szBuffcr [6000]; 

void EncodeXMLString(string szinput, string& szOutput) 
{ 

string strBuffer, 
size_l nFirstlndex; 
strBufTer = szinput; 

nFirstlndex ■» strBufrcr.findCT(">"), 0); 
while (nFirstlndex !«■ string: :npos) 

strBufier * strBuffer.rep!ace(nFirsiliKlex, _tcslen<_T(" 1")), _T{">")); 

nFirstlndex = strBuffer. findCTC^"), nFirstlndex+I); 

} 

nFirstlndex - strBuffer. findCT(" < ")» °)i 
while (nFirstlndex != string::npos) 

{ 

strBuffer = strBuffer.repiace(nFirstIndex, _tcslen<_TC 1")). _T("&U;"}); 

nFirstlndex = strBuffet-finddTC^''), nFirstlndex+l); 

} 

nFirstlndex = strBuffer.fiIld(_T( ,M ' , ), 0); 
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while (nFirstlndex !*» string: :npos) 

strBuffer - strBuffer.replacc(nFirstlndex, _tcslen(_TC I ")), _T{ M &apos;")); 

nFirstlndex - strBuffer. FmdCTC"'). nFirstlndex+l); 

} 

nFirstlndex = strBuffer. findCTCV'"). 0); 
while (nFirstlndex !» string: :npos) 

strBuffer = strBuffer.replace<nFir8tIndcx, jcslen(_TCr'))» _TC" w )); 

nFirsllndex - strBuffer. find(_T("\' ,,r ), nFirstlndex* 1); 

} 

nFirstlndex - strBuffcr.find(_Tr&''), O); 
while (nFirstlndex !« string:rnpos) 

if (nFirstlndex !- strBuiTerXmdCTO'&*'), nFirstlndex) && 
nFirstlndex != strBuffer.find(_T(">"), nFirstlndex) &.& 
nFirstlndex I- strBuffer. find(_TC<"), nFirstlndex) && 
nFirstlndex !- strBuffer.nnd(_T( , '&apos;''), nFirstlndex) && 
nFirstlndex strBuffcr findCTCAquot;*). nFirstlndex)) 
{ 

strBuffer - su*BufFer.replace(nFifstlndex, I , _T("&")); 
I 

nFirstlndex - strBuffer. ftndCT("&"). nFirstlndex+l); 

) 

szOutput » strBuffer; 
} //EncodeXMLString 
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LPTSTR GetDeviceStringProperty(HDEVINFO Devs,PSP_DEVINFO_DATA 

DevInfo.DWORD 

Prop) 

{ 

LPTSTR buffer; 
DWORD size; 
DWORD reqSize; 
DWORD dataType; 
DWORD szChars; 
size<= 1024; 

buffer - new TCHAR[(size/sizeof(TCHAR))+ 1); 
ifX'buffer) 



return NULL; 

while(!Sc*upDiGetDeviceRegisti^rop^ 
buffer,size,&.reqSize)) 
{ 

ifXGetLastErrorO !=■ ERROR IN SUFFIC IENT_BUFF ER) { 
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goto failed; 

} 

if(dataType != REG_SZ) { 
goto failed; 

} 

size « reqSize; 
delete {] buffer, 

buffer - new TCH AR[(size/si2eof(TCHAR))+l J; 
ifpbuffer) { 
goto failed; 

} 

} 

szChars - reqSiz«/sizeofl[TCHAR); 
buffer[szChars] =TEXTO0'); 
return buffer; 
failed: 
iftbuffer) { 

delete [] buffer; 

} 

return NULL; 

} 
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LPTSTR GetDcviceDescription(HDEVlNTO Dcvs,PSP J>EVINFO_DATA Devlnfo) 
LPTSTR desc; 

desc « GetDeviceSuingPtx>p<arty(Dcvs,De^ 

Wdesc) { 

desc « Getr>viceStrir»gProperty(Dcv8,Devlnfo,SPDRP_DEVlCEDESC); 

} 

return desc; 

} 

void replaces trfchar "Str.char *newDev!d, char ch) 

{ 

char.*word; 

word - strtok(Str,"&"); 

sticpy{newDevId,word); 

while(word!-NULL) 

word - strtok(NULL, , '&")-, 
ifl(word===NULL) break; 
strcatCnewDcvId^&ainp;"); 
strcat(newDevId,woid); 

} 

return; 

) 
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BOOL DumpDeviceWithlnfo<HDEVINFO DcvsJ»SP_DEVINFO_DATA DevInfo,LPCTSTR 
Info) { 

TCH AR devID[MAX DEVlCE_n>JLEN]; 
BOOL b ■ TRUE; 

SP_D£VlNFO_LIST_DETAJL_DATA dcvInfoLislDetat]; 
devlnfoListDctail-cbSizc - sizeofl(devlnfoListDelaU); 
»HCM Gel Device_ED(Devlnfo- 

>DevhUt,devID,MAX DEVICE ID LERO^CR.SUCCESS) 
i 

IstrepyCdevIDJEXTr?-)); 
b» FALSE; 

) 

string szDevlD=devID; 
string szOutputDevId; 

EncodeXMLString(szDevID^20utputf)evld); 
primf("\n%s"^20utputD«vld.c_strO); 
fprinlfIstream^\t\t<DeTO^^ 
return b; 

I 
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BOOL DumpDcviccDcscr(HDEVINFO Dcvs.PSP_DEVtNFO_DATA Devlnfo) 

LPTSTR desc, 

const int tStnngMaximumLcngth_c - 8048; 

WCHAR srwBigBufferCiStringMaximuniLcngth el; 

const int iMaxEighl_c - 10096; 

CHAR szBigBufCnfiMaxEight.c); 
desc » GetDeviccDescriptionfDevs.DevInfo); 
iff! desc) { 

printfC*\nDevice Description is not available for this device"): 
return FALSE; 

} 

MultiByieToWideChar(CP_ACP, 0, desc, - I. szwBigBufler. 
stzeof(«wBigBuffer)); 

« WideCharToMultiByte(CP_UTF8, 0. szwBigBuffer, - 1 , szBigBuffer, 
sizcoftszBigBufrer). NULL, NULL); 
|P«Mtfstreamr\n\t\i«l^i^^ 
tier); 

printrt'*\n%s",dDSc); 
delete fj desc; 
return TRUE; 

I 

BOOL OumpDeviceStatus(HDEVrNFO Devs,PSPJDEVINFOJ>ATA Devlnfo> 
SP_DEVTNFO,LIST_DETAlL_DATA devlnfoListDetail; 
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ULONG status « 0; 

ULONG problem ** 0; 

BOOL haslnfo » FALSE; 

CMAPI CONFIGRET WIN API CM Get DevNode_Status(OUT PULONG 
pulStatus,OUT PULONG puIProblemNumbcrJN DEV1NST dnDevInslJON ULONG ulFlags ); 

devinfoListDetaiLcbSize ■ sizeof(devInfoLi8iDetait); 
iffCM Get DcvNode Siatus(^tatus > &prob^^ 

return FALSE; 

\ 

printfHnEnor Code : %i\problem); 
fjprintftrtream/^W^ 
iflXstatus & DN HA3JPROSLEM) problem — CMJPROBJ5ISABLED) 

< 

haslnfo « TRUE; 

printfr , \n%a*, ,, Dcvice is disabled"); 

fprinlf(streanC^ is disabled**); 

return TRUE; 

} 

iffctatus&DN HAS PROBLEM) 

{ 

haslnfo » TRUE; 
printfl[ H \n%s H , f 'Devicc has a problem"); 

IprintRstK^^^ has a problem 11 ); 

) 

instates & DNJPRIVATE PROBLEM) 
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{ 

haslnfo = TRUE; 

printfnn%sV'Dcvicc has a problem reportetr by the driver"); 
e driver")- ^^ SWOT>M ^ tetus> ^ %sV ' </S,atu$> "."Device has a problem reported by 
1 

if{status&DN STARTED) 
{ 

printfl["\n%s","Device has been started"); 
j frrintRstrcam,"\n\t\t<St^^ ha3 been s^^). 

else if (fhaslnfo) 




return TRUE; 



int GetDeviceInfoAndDelete(char * devfJDtoDelete) 
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{ 

HDEVINFO devs - INVALID__HANDLE_VALUE; 
DWORD err; 

int failcode - EXIT_FA1L; 

DWORD devlndex; 

SP DEVINFO_DATA devtafo; 

SP_DEVINFO_LIST - DETAIL_DATAdcvInfoLt8tDet3il; 
BOOL matchFound - FALSE; 
SP_REMOVEDEVlCE_PARAMS rmdParams; 
LPCTSTR action = NULL; 
TCHAR dcvID[MAX_DEVICE_ID_LEN); 

devlnfoListDetail.cbSize *» sizeof(devInfoListDetail); 

printft"Device to be deleted is %s", devIDtoDelete); 
devs = SetupDiGetClassDcvs( 
NFULUNnJLUNULUDIGCF_ALLCLASSESpiGCF_PRESENT); 

if^devs — INV ALID_HAND LE VALUE) 

{ 

err = GetLastErrorO; 

printf( "SetupDiGetClassDevs failed: %lx.\n", err ); 

failcode=EXTT_FAIL; 

goto final; 

} 
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devInfoListDetail JteiwteMachineHandle ■ NULL; 

strcpy(dcvInfoUstDetaiLR€moieMachineNanie, l,ff ); 
dcvInfoLisiDctail.cbSize ■ sizeofldevlnfoListDetaii); 

devlnfoUstDetailxbStee • 8izeof(SP^DEViNFO^UST^DETAIL^DATA); 
devlnfo.cbSize « sizeof(devlnfo); 
for(devliKJexH);SetupDiEnumDtviceln^ 

i 

if(CM Get Device ID(devInfo.DevInst,devID,MAX^DEVICE ID IEN,0)!<R SUCCESS) 
I 

Utrcpy(devID,TEXTH tt )); 

printf^Dev ID for comparison is : %s \n w ,devlD); 
if[strtmp(devID i devIDtoDclete) s =0) 

{ 

primfpto match found"); 
matchFotrod-TRUE; 
rmdParams.QassInstallHcadcr.cbSitc • 
sizcof(SP_CLASSINSTALL^HEADER); 

rradPa^s.ClassInstallHeader.IiistanFuiiction - 

DIP REMOVE; 

rmdParams.Scope - DI_REM0VEDEVICEJ3M)BAL; 

rmdParamaHwProfile ■ 0; 
itySetupDiSetClasstastaW 
sizeoflrmdParams)) ||!SettipDiC^^ 
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{ 

failcode - EXIT_FA1L; 
goto final; 

> 

printfC\n\n Device has been deleted"); 
break; 

} 

) 

// The device was deleted ! ! 
iilmatchFound — FALSE) 

{ 

printfTVn\n No matching device id found! ! n ); 
failcode » EXIT FAIL; 

} 

else 
i 

failcode = EXIT OK; 

} 

final: 

if(dcvs !- INVALID_H ANDLE_V ALUE) { 
printfTdestorying DevsInfoList"); 
SetupDiDestroyDeviceInfoList<devs); 
^ printfT After destorying DevsInfoList"); 

return failcode; 

I 
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int EnumerateDevice() 
{ 

HDEVINFO devs - INVALIDHANDLE VALUE; 
DWORD err; 

int failcode = EXIT FAIL; 
DWORD devlndexf 
SP_DEVJNFO_DATA devlnfo; 

SP_DE VINFO_LIST_DETAIL_D ATA devInfoListDetail ; 
DWORD numClass = 0; 
int skip = 0; 

devs = SetupDiGetClassDevs( 
NULL,NULL,NULL,DIGCF_ALLCLASSESPIGCF_PRESENT); 

//devs = SetupDiGelC7assDevs( 
NULL.NULL,NULL.DIGCF ALLCLASSES|DIGCF_PROFILE); 
ifTdevs — INVALID HANDLE_VALUE) 
{ 

err ■ GetLastError(); 

prtntR "SetupDiGetClassDevsEx failed: %lx.\n", err ); 
failcode- EXIT_FAIL; 
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goto final; 

» 

devhfoListDetail.RemoteMachineHandlc = NULL; 
strcpy<devlnfoListDcw^!.Rem<>teMachjneName,'" , ); 
devInfoListDetail.cbSize » sizeof(devInfoListDetail); 

dcvlnfoListDetail.cbSizc*sia»of(SP_DEVINFO LIST_DETAIL DATA)- 
devlnfo.cbSize - sizeotfdevlnfo); 

MdwuTdex^SetupDiEnumDevicetafo^ 

TCHAR devn>{MAX,DEVICE_ID LEN]; 
if(CM_Get_Device_ID<dcvInfo.DcvIim,devID,MAX_DEV 

lstrepy(devID,TEXT("?")); 

11 printiTDev ID for comparison is : %s \n",devID); 

print(T\n\n"); 

iprratf^3treaIn,^\t<Device> ,, ); 

if(!DumpDeviceWithInfo(devs,&devInft),NULL)) return EXIT OK- 
DumpDeviccDescr(dcvs,&<lcvIafo); 

DumpDeviceStatus(d6vs,&devInfo); 
^)rint^^[5tream,' , \n\t</DevicO' , ); 
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} 

failcode = EXIT_OK; 
final: 

if(devs != INVALID_HANDLE_VALUE) { 
SctupDiDestroyDeviceInfoList(devs); 

} 

return failcode; 

I 

int rcmoveDevicefchar *devID) 

i 

printfT%s",devlD); 

return GetDevicelnfoAndDelete(devID); 

) 

int listDeviceStatusO 
I 

int result; 

if(outfile!=NULL) 
{ 

stream = fopen(outfilc, V ); 

> 

else 
{ 

stream - fopen("devlist.xmr, "w" ); 
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} 

fprintf(stream f "<DcviccManagcr>' , )r; 
result - EnumerateDeviceO; 

fprintf(st^cam,"\n</DcviccManagc^> ,, ); 
fclose( stream ); 
return result; 

} 

void writeReturnCode(mt code) 
{ 

FILE "Ostream; 

Ostream = fopen( "DMStatus.out", V ); 

fprimfl[Ostreaiii l "%i w ,code); 

fclose(Ostreain); 

) 

void main(int argc,LPTSTR argv[J) 
{ 

int retval; 
ifl[argc<2) 

{ 
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printf^Wrong arguments"); 

writeRetumCode(3); 

exit(3); 

) 

i f{strcmp(argv[ 1 ] t "remove">=0) 
{ 

//Check if the id is specified 

printfl[ "calling remove device %s argv[2]); 

ifTargv[2]=NULL) 

{ 

printfC'Mi8stng device id"); 

writeReturnCode(3); 

exit(3); 

} 

retval = removeDevtce(argv[2]); 

writeRetumCode(retval); 

exit(retval); 

} 

\f( strcmp(argv [ 1 ] f °status ## )™0) 
{ 

// if the out file name is specified 

if{argc=~3) 

{ 

outfile =argv[2]; 
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} 

writeRetu rnCode(2); 
exit(2); 

} 



In column 16, line 2, in Claim 3, delete "Suitable" and insert — suitable — , therefor. 
In column 16, line 52, in Claim 9, delete "deivce" and insert - device --, therefor. 



printflpCalling status 11 ); 
retva! » listDeviceStatus(); 
writeReturnCode(retval); 
exit(retval); 
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